home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / bpatch.1 < prev    next >
Text File  |  1995-07-25  |  8KB  |  199 lines
  1.  
  2.  
  3.  
  4.      BBBBPPPPAAAATTTTCCCCHHHH((((1111))))                 UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                 BBBBPPPPAAAATTTTCCCCHHHH((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           bpatch - binary patch and dump file utility
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           bpatch [ -b blksize ] [ -d ] [ -D pagecnt ] [ -e ] [ -p ] [
  13.           -r reclen ] [ -s ] [ -x ] file...
  14.  
  15.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.           _B_p_a_t_c_h allows the viewing and/or modification of files,
  17.           independent of file type (text, executable, data file, and
  18.           so forth).  _B_p_a_t_c_h allows the data to either be examined at
  19.           the terminal, dumped to a print device or file, or edited in
  20.           the general manner of _v_i(_1).  The data in the file is dumped
  21.           or displayed in _p_a_g_e_s of 256 bytes.
  22.  
  23.         OOOOppppttttiiiioooonnnnssss
  24.           -b blksize  The -_b option specifies the blocksize of the
  25.                       data file.  This is used primarily with tapes,
  26.                       and is allowed only with one of the dump (-_d or
  27.                       -_D) options.  When this option is specified, the
  28.                       file is opened in readonly mode.
  29.  
  30.           -d          The -_d option indicates that a dump (no terminal
  31.                       manipulation) is to be performed.  The entire
  32.                       file will be dumped to standard output.  No
  33.                       editing of the data is allowed and the file is
  34.                       opened in readonly mode.
  35.  
  36.           -D pagecnt  The -_D option is similar to the -_d option, with
  37.                       the following exception: the pagecnt argument
  38.                       limits the dump to the specified number of
  39.                       _p_a_g_e_s.
  40.  
  41.           -e          The -_e option indicates that the file contains
  42.                       EBCDIC data and should be converted in the
  43.                       character portion of the dump.
  44.  
  45.           -p          Used with one of the _d_u_m_p options, this option
  46.                       causes the program to pause between _p_a_g_e_s.  The
  47.                       program will then wait for the user to press
  48.                       either the _r_e_t_u_r_n key to continue, or the _D_E_L
  49.                       (or _r_u_b_o_u_t) key to stop the dump.
  50.  
  51.           -r reclen   The -_r option indicates the record length of the
  52.                       data within the dump.  When specified, this
  53.                       option causes _b_p_a_t_c_h to place a colon (:)
  54.                       between the last byte of one record and the
  55.                       first byte of the next.
  56.  
  57.           -s          This option turns on the byte swap option.  It
  58.                       may be toggled dynamically during execution (see
  59.                       -_x under Commands below).
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 3/9/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      BBBBPPPPAAAATTTTCCCCHHHH((((1111))))                 UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                 BBBBPPPPAAAATTTTCCCCHHHH((((1111))))
  71.  
  72.  
  73.  
  74.           -x          This option specifies the suppression of pages
  75.                       that contain only NUL characters.  The result is
  76.                       that only the page header (name and page number)
  77.                       will appear for such a page.  This option may
  78.                       only be used with one of the dump options.
  79.  
  80.         AAAArrrrgggguuuummmmeeeennnnttttssss
  81.           file        Any number of files may be specified.
  82.  
  83.         CCCCoooommmmmmmmaaaannnnddddssss
  84.           All commands are valid only in the non-dump, interactive
  85.           mode.  Commands may be entered in either upper or lower
  86.           case.  Commands of the form '^x' indicate that the control
  87.           character _x is to be entered.
  88.  
  89.           All commands that request movement within a file or between
  90.           files cannot be executed if any changes have been made.  To
  91.           proceed in this case, the user must either enter the _w
  92.           command, the _u command, or the _r command.
  93.  
  94.           Requesting a next or previous file when there is no such
  95.           will cause the issuance of an error message.
  96.  
  97.           Note that certain commands allow/require either some text or
  98.           numeric value.  In those cases, the user should type in
  99.           characters and end the string with either a <cr> or <DEL>.
  100.  
  101.           ?     Display the help screen.  The help screen will remain
  102.                 until the user either redraws the screen (see ^_r) or
  103.                 changes pages or files.
  104.  
  105.           !     Execute the following command in the shell.
  106.  
  107.           backslash
  108.                 Display the previous page.
  109.  
  110.           <cr>  Display the next page.
  111.  
  112.           DEL   Quit the program if no changes have been made.
  113.  
  114.           /     This command initiates an ASCII search.  The text
  115.                 entered on the command line will be used as a search
  116.                 string, and the file will be searched starting with
  117.                 the current page.  When the string is found, the page
  118.                 containing the string will be displayed.  If the
  119.                 string is not found, an apapropriate message will be
  120.                 displayed.
  121.  
  122.           ^f    Open a named file whose name will be entered on the
  123.                 command line and followed either by <cr> or DEL.
  124.  
  125.           ^n    Open the next file and display the first page.
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 3/9/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      BBBBPPPPAAAATTTTCCCCHHHH((((1111))))                 UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                 BBBBPPPPAAAATTTTCCCCHHHH((((1111))))
  137.  
  138.  
  139.  
  140.           ^p    Open the previous file and display the first page.
  141.  
  142.           ^q    Quit without writing current changes.
  143.  
  144.           ^r    Redraw the screen.
  145.  
  146.           NNN   Entering a numeric value requests that the specified
  147.                 page be displayed.
  148.  
  149.           -x    Toggle the command line option represented by _x:
  150.  
  151.                       a     Toggle display to ascii (assume data is
  152.                             ascii).
  153.  
  154.                       e     Toggle display to dbcdic (assume data is
  155.                             ebcdic).
  156.  
  157.                       s     Toggle byte swap.
  158.  
  159.           a     Edit the ASCII display.  End edits by pressing the DEL
  160.                 key.  All other characters will be treated as valid
  161.                 input.  Cursor movement keys (arrows and home) allow
  162.                 movement within the edit window.  Nonprinting
  163.                 characters are displayed as dot (.) in this window.
  164.  
  165.           f     Display the first page in the current file.
  166.  
  167.           g     Display the page containing the byte address typed in
  168.                 following the command.
  169.  
  170.           h     Edit the HEXADECIMAL display.  End edits by pressing
  171.                 DEL key.  Cursor movement keys (arrows and home) allow
  172.                 movement within the edit window.  Two keystrokes are
  173.                 required to modify a byte, and both must be valid
  174.                 hexadecimal values (0-9 and a-f).  To cancel a change
  175.                 after typing one character, press DEL.
  176.  
  177.           l     Display the last page in the current file.
  178.  
  179.           q     Quit the file.  A warning will be issued if any
  180.                 changes have been made but not written out.
  181.  
  182.           r     Reread the current page.
  183.  
  184.           u     Undo all changes to the current page.
  185.  
  186.           w     Write out the current page.
  187.  
  188.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  189.           od(1)
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 3/9/94)
  196.  
  197.  
  198.  
  199.